home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1996 April / Macworld (1996-04).dmg / Shareware World / Entertainment / General / Gravitation 4.0 / Gravitation Ltd.docs < prev   
Text File  |  1990-03-20  |  10KB  |  279 lines
  1. Gravitation Ltd.  4.0
  2.  
  3.  
  4. ◊What is it?
  5.  
  6.     Gravitation Ltd. is a graphic, two dimensional orbital 
  7. simulation.  Users can enter custom designed solar systems or run 
  8. previously created ones.  Systems can be views at varying zoom 
  9. levels, recorded and played back at high speed, and edited via the 
  10. graphic solar system editor.
  11.  
  12.  
  13. ◊A Gravity Primer
  14.  
  15.     Gravity is the force of attraction between any two objects.  The 
  16. strength of that force depends on the distance between the two 
  17. objects, the mass of each object, and a gravity constant.  This force 
  18. can be represented by the formula    Force = (g * M1 * M2)/D2 
  19. where g= gravity constant, M1 is the mass of the first object, M2 is 
  20. the mass of the second object, and D is the distance between them.  
  21. Accordingly, as the two objects come closer the gravitational pull 
  22. increases.
  23.  
  24.     Also, as the mass of either or both objects increases, the 
  25. gravitational pull will increase.  How much a given gravitational pull 
  26. affects an object depends on that object’s mass.  A small pull on a 
  27. heavy object will cause very little change in the object's speed and 
  28. position (a small acceleration).  A large pull on a light object will 
  29. cause a strong acceleration. 
  30.  
  31.  
  32. ◊Using Gravitation Ltd.
  33.  
  34.  
  35. •File Operations•
  36.  
  37.     Solar systems can be opened or saved via the OPEN and SAVE 
  38. commands in the File menu.  
  39.  
  40.  
  41. •About the Editor•
  42.  
  43.     The Graphic Editor, located under the Edit menu, is used to] 
  44. design or modify model solar systems.  It allows you to do the 
  45. following:
  46.  
  47. Create and delete planets (Max. 10 Planets).
  48.  
  49. Specify Mass for each planet.  Mass must be in the range of 1..900.
  50. Specify X and Y location for each planet.  Units are pixels, with 0,0 
  51. being center screen.
  52. Specify X Velocity and Y Velocity for each planet (-10..10).  Units are 
  53. pixels per frame.
  54. Specify Trace Enable for each planet.  This selection will leave a trail 
  55. behind the planet when applicable.
  56. Specify Stationary for each planet.  Stationary will lock that object in 
  57. place so that it is unaffected by the gravitational pull of other 
  58. objects.
  59.  
  60.     Two displays in the editor allow you to see what effects your 
  61. changes will have.  The first and larger one is the Planet Display, 
  62. which is a reduced scale view of the screen as it will look when you 
  63. leave the editor.  The second is the Velocity Vector Display.  This 
  64. display lets you see the starting direction and speed of the currently 
  65. selected planet.
  66.  
  67.  
  68. •Using the Editor•
  69.  
  70.   Buttons:
  71.  
  72.  Create:        Creates a new planet and selects it.
  73.  Delete:        Erases currently selected planet and selects next 
  74.             planet.
  75.  Next:        Select next planet.
  76.  Prev. :        Select previous planet.
  77.  O.K. :        Leave the editor and return to main program.
  78.  Trace:        Will leave a trail behind the currently selected 
  79.             planet.
  80.  Stationary:    Locks the current planet in position.
  81.  
  82.   Edit boxes:
  83.  
  84.     Used to enter Mass, X and Y location, and X and Y velocity for 
  85. each planet.
  86.  
  87.   Planet Display:
  88.  
  89. The planet display, the large grid in the upper right of the editor, 
  90. gives a graphical representation of the current solar system as it will 
  91. appear on your screen.  This display is also a control in the sense that 
  92. planets can be both clicked on to select them and view their data, 
  93. and also dragged around the screen to move them.  The selected 
  94. planet is shown with a rectangle around it.  The three round buttons 
  95. located below the planet display, 1x, 2x and 4x, control the viewing 
  96. distance for the planet display (1x = close up view,  4x = viewing 
  97. from far away. — Try it, you'll see).
  98.  
  99.   Velocity Vector Display:
  100.  
  101. The velocity vector display complements the planet display by 
  102. providing a graphical representation of the velocity(Speed) and 
  103. direction of the selected planet.  This display can also be changed by 
  104. clicking in it.  The VVD will reflect the settings of the X velocity and 
  105. Y velocity text boxes and vice versa.
  106.  
  107. Although all of this may seem complicated, I think it you will find it 
  108. all very clear when you see it and work (Play?) with it.  Just click 
  109. around and try things.
  110.  
  111.  
  112. •Go Menu Commands•
  113.  
  114. Run:
  115.     Starts the current simulation.
  116.  
  117. Set Pause At...
  118.     Set pause at brings up a dialog box that allows the simulation 
  119. to automatically stop,stop and beep, or repeat at a specified frame.  
  120. The preset frame number is the maximum number of frames that 
  121. can be recorded by the Instant Replay device (see below).  Using a 
  122. larger number will mean that early replay tape will be overwritten.
  123.  
  124. Limit Speed:
  125.     Limit Speed will limit the simulation to a maximum of 30 
  126. frames per second.  This will keep simulations from going too fast, 
  127. especially when run on powerful Macintoshes.  Users of standard 
  128. 68000 based Macs will rarely need to use this feature.  Limit speed 
  129. applies to normal Run mode and also to Instant Replay Play mode 
  130. (see instant replay below).
  131.  
  132. Anti Drift:
  133.     Anti drift calculates a Zero Momentum Frame.  That is, anti 
  134. drift will zero the total velocity of the model solar system.  This will 
  135. help keep the system from drifting off of the screen.  Anti Drift is a 
  136. one time calculation done only at frame zero. Therefore, for it to take 
  137. effect, you must be at frame zero or use the Reset command or 
  138. enter/exit the editor to get to frame zero.  Anti drift will have no 
  139. effect if any planets are locked in place with stationary.  Indeed, the 
  140. whole purpose of the anti drift feature is to avoid having to lock any 
  141. planets in place, yet still have the simulation stay centered on the 
  142. screen.  
  143.  
  144. Reset:
  145.     Reset clears the screen and returns the simulation to its 
  146. starting point (frame zero).  All replay tape is erased.
  147.  
  148.  
  149. •Instant Replay Menu Commands•
  150.  
  151. Instant Replay:
  152.     Selecting instant replay will bring up an instant replay palette 
  153. in the upper right corner of the screen.  This device will let you 
  154. review the previous 2400 frames.  The five buttons in the palette 
  155. from left to right are...
  156.  
  157.    Rewind:  Rewinds the "tape" back to the beginning at high speed.
  158.    Stop:  Stops the tape.
  159.    Play:  Runs the tape forward at normal speed(limited by the limit 
  160. speed command).
  161.    Fast Forward:  Moves the tape forward at high speed.
  162.    Exit Playback:  Returns to the main simulation.
  163.  
  164. The primary purpose of the replay device is to allow you to review 
  165. simulations at speeds greater than are possible when first calculating 
  166. them.  The replay device does not have to calculate as it displays 
  167. frames and is therefore much faster.  Remember, only 2400 frames 
  168. can be stored.  Additional frames will take the place of the oldest 
  169. frames.  The scroll bar on the bottom of the replay box can be clicked 
  170. on to quickly move through the replay tape.
  171.  
  172. Normal Play:
  173.     Returns the program to the main simulation at the frame it was 
  174. at when instant replay was entered.  This is the same as clicking on 
  175. the Exit Playback button.
  176.  
  177.  
  178. •Display Menu Commands•
  179.  
  180. Trace On:
  181.     Trace On activates the tracing of all planets that have been 
  182. selected as Trace Enable in the editor. This will leave a trail of dots 
  183. behind those planets.
  184.  
  185. Clear Trace:
  186.     Clear trace will erase all previous trace dots.
  187.  
  188. Normal Zoom, Zoom Out 2x, Zoom Out 4x:
  189.     These three items control the scale at which the solar system is 
  190. displayed. Normal Zoom is a close up view, and Zoom Out 4x is a 
  191. distant view which will allow you to see a larger area.
  192.  
  193. Frame Counter:
  194.     This command brings up a counter in the upper left of the 
  195. screen which shows how many frames have passed since the 
  196. simulation began.
  197.  
  198.  
  199. •Collisions etc.•
  200.  
  201.     When two or more planets collide their mass and momentum 
  202. will be added to form a single new planet.  Stationary or trace 
  203. attributes will be combined into the Or of the original planets.  
  204. Because the number of calculations required increases geometrically 
  205. as the number of planets is increased, large simulations will run 
  206. slowly.  Use instant replay to review them at high speed after they 
  207. have been calculated.
  208.  
  209.  
  210. •Gravitation Documents.•
  211.  
  212.     Numerous Gravitation Ltd. solar systems are available on 
  213. bulletin boards and online services.  Please take the time to upload 
  214. solar systems that you design to any available services.  This gives 
  215. others a chance to share in your creativity.  If your service has a 
  216. keyword search capability, please include the keyword " Gravitation 
  217. "  with your file so that users can quickly find all available files.  If 
  218. your online service does not have a copy of Gravitation Ltd. 4.0, 
  219. please upload it - this would be especially appreciated.  Thank you.
  220.  
  221.  
  222. •Technical Stuff•
  223.  
  224. Compatibility:
  225.     Gravitation Ltd. 4.0 should run on 512K, 512KE, Plus, SE, Mac 
  226. II.
  227.  
  228. Memory usage and Multifinder:
  229.     Gravitation Ltd. 4.0 requires about 400 K to run, but large 
  230. screen Macs may require more memory (Up to about 650 K.).  If 
  231. insufficient memory is available the program should alert you when 
  232. you start it up.  Within these memory guidelines, it should be fine 
  233. with Multifinder.  Future compatibility, both with software and 
  234. hardware, has been striven for but cannot be guaranteed (Naturally).
  235.  
  236.  
  237. •The Bottom Line•
  238.  
  239.     This program is Shareware.  I have put many hours into 
  240. creating a simulation that I hope you will find interesting.  In return 
  241. for this, please write me and if possible, enclose a small sum of 
  242. money for my efforts.  If you can’t afford  to send even a small 
  243. amount, then just send me your Mac. (Just kidding).  Seriously 
  244. though, even a simple letter or post card would be greatly 
  245. appreciated.  This lets me know where my program has traveled and 
  246. what people think of it.  Thank you for your honesty and support. 
  247.  
  248.  
  249.  
  250. Jeff Rommereide
  251. 343 Elma Ave.
  252. Laurel Springs, N.J.  08021
  253.  
  254. Genie: J.Rommereide
  255. Compuserve: 73710,467
  256.  
  257.  
  258. Version Information.
  259.  
  260. 1.0  Original Program.   Dec. 1987
  261. 2.0  Upgraded to take advantage of Mac II and other large screens, 
  262. minor feature additions, minor bug fixes.    April 1988.
  263. 2.5  Enhanced speed (up to 40%), ability to open and save model solal 
  264. systems, cleaner editor, minor bug fixes.    May 1988.
  265. 4.0  Zoom capability, enhanced editor, instant replay, frame counter, 
  266. anti-drift option, pause-at, limit speed option, bug fixes.     October 
  267. 1988.
  268.  
  269.  
  270. Gravitation Ltd. Version 4.0 and documentation are Copyright 1988 
  271. By Jeff Rommereide.
  272.  
  273.  
  274. All rights reserved.  Not legal for commercial distribution without 
  275. prior consent by the author.
  276.  
  277.  
  278. All inquiries welcome, commercial software development etc.
  279.